package com.business.api.official.toursism.websitecomment.service;

import com.business.api.official.toursism.websitecomment.dto.WebsiteCommentApiDTO;
import com.business.api.official.toursism.websitecomment.from.WebsiteCommentApiSaveFrom;
import com.business.api.official.toursism.websitecomment.from.WebsiteCommentApiUpdateFrom;
import com.business.api.official.toursism.websitecomment.query.WebsiteCommentApiPageQuery;
import com.business.api.official.toursism.websitecomment.query.WebsiteCommentApiQuery;
import com.business.api.official.toursism.websitecomment.vo.*;
import com.business.api.official.toursism.websitecomment.vo.data.WebsiteCommentApiDetailData;
import com.business.system.official.toursism.websitecomment.entity.WebsiteComment;
import com.seed.core.exception.ServiceException;
import com.seed.core.pojo.service.SeedApiService;

/**
 * @description 评论
 * @author CodeGenerator
 * @date   2025-01-25
 * @version V1.0
 */
public interface WebsiteCommentApiService extends SeedApiService<WebsiteComment>{

    /**
     * 持久化
     *
     * @param websiteCommentFrom 需要保存的对象
     * @return id，如果保存失败返回空字符串
     * @throws ServiceException 业务层异常
     */
    WebsiteCommentApiDTO save(WebsiteCommentApiSaveFrom websiteCommentFrom) throws ServiceException;

    /**
     * 部分更新
     *
     * @param websiteCommentFrom 需要更新的对象
     * @return 是否成功
     * @throws ServiceException 业务层异常
     */
    WebsiteCommentApiDTO updateSelectiveById(WebsiteCommentApiUpdateFrom websiteCommentFrom) throws ServiceException;

    /**
     * 获取全部
     *
     * @param query 查询条件
     * @return 详情VOList
     * @throws ServiceException 业务层异常
     */
    WebsiteCommentApiDetailListVO listAll(WebsiteCommentApiQuery query) throws ServiceException;

    /**
     * 简略对象条件查询
     *
     * @param query 查询条件
     * @return 查询出来的简略对象
     * @throws ServiceException 业务层异常
     */
    WebsiteCommentApiBriefPageVO getBriefPageVO(WebsiteCommentApiPageQuery query) throws ServiceException;

    /**
     * 详细对象条件查询
     *
     * @param query 查询条件
     * @return 查询出来的详细对象
     * @throws ServiceException 业务层异常
     */
    WebsiteCommentApiDetailPageVO getDetailPageVO(WebsiteCommentApiPageQuery query) throws ServiceException;
}
